home *** CD-ROM | disk | FTP | other *** search
- <?xml version="1.0" encoding="EUC-KR" ?>
- <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
- <?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
- <!-- English Revision: 1.2.2.5 -->
-
- <!--
- Copyright 2004 The Apache Software Foundation
-
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
- -->
-
- <modulesynopsis metafile="mod_example.xml.meta">
-
- <name>mod_example</name>
- <description>╛╞╞──í ╕≡╡Γ API╕ª ╝│╕φ╟╤┤┘</description>
- <status>Experimental</status>
- <sourcefile>mod_example.c</sourcefile>
- <identifier>example_module</identifier>
-
- <summary>
- <note type="warning">
- └╠ ╣«╝¡┤┬ ╛╞╞──í └Ñ╝¡╣÷ 2.0 ╣÷└ⁿ┐í╝¡ ║»░µ╡╚ │╗┐δ└╗ ┤π░φ
- └╓┴÷ ╛╩┤┘. ╛╞┴≈╡╡ └»╚┐╟╤ ┴ñ║╕░í └╓┴÷╕╕, ┴╓└╟╟╪╝¡ ╗τ┐δ╟╧▒µ
- ╣┘╢⌡┤┘.
- </note>
-
- <p>╛╞╞──í ╣Φ╞≈║╗ <code>src/modules/example ╡≡╖║┼Σ╕«</code>┐í
- └╓┤┬ ╞─└╧╡Θ└║ ╛╞╞──í API╕ª ╗τ┐δ╟╧┐⌐ ╕≡╡Γ└╗ └█╝║╟╧╖┴┤┬ ╗τ╢≈╡Θ└╗
- ╡╜▒Γ└º╟╤ ┐╣┴ª┤┘.</p>
-
- <p><code>mod_example.c</code>┤┬ ╕≡╡τ ─▌╣Θ(callback) ▒╕┴╢┐═
- ╚ú├Γ ╣«╣²└╗ ╝│╕φ╟╧┤┬ ╞─└╧└╠┤┘. ┤τ╜┼└║ ╕≡╡Γ┐í └╠ ╕≡╡τ ─▌╣Θ└╗
- ▒╕╟÷╟╥ ╟╩┐Σ░í ╛°┤┘. ╗τ╜╟ ┴ñ╣▌┤δ┤┘!</p>
-
- <p>example ╕≡╡Γ└║ ╜╟┴ª╖╬ ╡┐└█╟╧┤┬ ╕≡╡Γ└╠┤┘. └╠ ╕≡╡Γ└╗ ╝¡╣÷┐í
- ┐¼░ß╟╧░φ ╞»┴ñ └º─í┐í "example-handler" ╟┌╡Θ╖»╕ª ╟╥┤τ╟╧┐⌐
- ▒╫░≈└╗ ║Ω╢≤┐∞┬í╟╧╕Θ example ╕≡╡Γ└╟ ┐⌐╖» ─▌╣Θ└╗ ╚«└╬╟╥ ╝÷
- └╓┤┘.</p>
- </summary>
-
- <section id="compiling"><title>example ╕≡╡Γ ──╞─└╧╟╧▒Γ</title>
-
- <p>╝¡╣÷┐í example ╕≡╡Γ└╗ ╞≈╟╘╟╧╖┴╕Θ ┤┘└╜ ░·┴ñ└╗ ░┼─ú┤┘:</p>
-
- <ol>
- <li>
- <code>src/Configuration</code> ╞─└╧ ╛╞╖í ║╬║╨┐í └╓┤┬
- "AddModule modules/example/mod_example" ┴┘└╟ ┴╓╝«├│╕«╕ª
- ╛°╛╪┤┘. └╠╖▒ ┴┘└╠ ╛°┤┘╕Θ, ┤┘└╜░· ░░└║ ┴┘└╗ ├▀░í╟╤┤┘.
- <example>
- AddModule modules/example/mod_example.o
- </example>
- </li>
-
- <li><code>src/Configure</code> ╜║┼⌐╕│╞«╕ª ╜╟╟α╟╤┤┘
- ("<code>cd src; ./Configure</code>"). ▒╫╖»╕Θ
- ╝¡╣÷ └┌├╝ Makefile└╗ ╕╕╡Θ░φ, ╟╧└º╡≡╖║┼Σ╕«┐í └╓┤┬ ┐Σ├╗╟╤
- ├▀░í ╕≡╡Γ└╗ <code>src/modules/Makefile</code>┐í ├▀░í╟╤┤┘.</li>
-
- <li>╝¡╣÷╕ª ──╞─└╧╟╤┤┘ (<code>src</code> ╡≡╖║┼Σ╕«┐í └╓┤┬
- "<code>make</code>"╕ª ╜╟╟α╟╤┤┘).</li>
- </ol>
-
- <p>└┌╜┼└╠ ╕╕╡τ ╕≡╡Γ└╗ ├▀░í╟╧╖┴╕Θ:</p>
-
- <ol type="A">
- <li><code>mkdir src/modules/<em>mymodule</em></code></li>
-
- <li><code>cp src/modules/example/*
- src/modules/<em>mymodule</em></code></li>
-
- <li>╗⌡╖╬ ╕╕╡τ ╡≡╖║┼Σ╕«┐í └╓┤┬ ╞─└╧└╗ ╝÷┴ñ╟╤┤┘.</li>
-
- <li>└√└²╚≈ ╝÷┴ñ╟╧┐⌐ └º└╟ [1]┐í╝¡ [3]▒ε┴÷ ░·┴ñ└╗ ┴°╟α╟╤┤┘.</li>
- </ol>
- </section>
-
- <section id="using"><title><code>mod_example</code> ╕≡╡Γ ╗τ┐δ╟╧▒Γ</title>
-
- <p>example ╕≡╡Γ└╗ ╗τ┐δ╟╧╖┴╕Θ <code>srm.conf</code> ╞─└╧┐í
- ┤┘└╜░· ░░└║ ╝│┴ñ└╗ ├▀░í╟╧╢≤:</p>
- <example>
- <Location /example-info><br />
- SetHandler example-handler<br />
- </Location>
- </example>
-
- <p>╛╞┤╧╕Θ <a
- href="core.html#accessfilename"><code>.htaccess</code></a>
- ╞─└╧┐í ┤┘└╜░· ░░└║ │╗┐δ└╗ ├▀░í╟╧░φ, ▒╫ └º─í┐í╝¡ "test.example"
- ░░└║ ╞─└╧└╗ ┐Σ├╗╟╧╢≤:</p>
- <example>
- AddHandler example-handler .example
- </example>
-
- <p>╝¡╣÷╕ª └τ╜├└█╟╤ ╚─ └╠ └º─í╕ª ║Ω╢≤┐∞┬í╟╧╕Θ ╛╒┐í╝¡ ╕╗╟╤
- │╗┐δ└╗ ║╕░╘╡╔ ░═└╠┤┘.</p>
- </section>
-
- <directivesynopsis>
- <name>Example</name>
- <description>╛╞╞──í ╕≡╡Γ API╕ª ╝│╕φ╟╧▒Γ└º╟╤ ┐╣┴ª ┴÷╜├╛ε</description>
- <syntax>Example</syntax>
- <contextlist><context>server config</context>
- <context>virtual host</context><context>directory</context>
- <context>.htaccess</context></contextlist>
-
- <usage>
- <p><directive>Example</directive> ┴÷╜├╛ε┤┬ example ╕≡╡Γ└╟
- │╗┐δ╟┌╡Θ╖»░í ░ú┤▄╟╤ ╣«▒╕╕ª ║╕└╧┴÷ ┐⌐║╬╕ª ╝│┴ñ╟╤┤┘. └╠ ┴÷╜├╛ε┤┬
- ╛╞▒╘╕╒╞«╕ª ╣▐┴÷╛╩┤┬┤┘. example │╗┐δ╟┌╡Θ╖»╕ª └√┐δ╟╤ URL┐í
- ┴ó╝╙╟╧╕Θ ╣«╝¡ ┐Σ├╗└╗ ╝¡║±╜║╟╧▒Γ└º╟╪ ╕≡╡Γ╛╚┐í ╟╘╝÷╡Θ└╠ ╛ε╢╗░╘
- ▒╫╕«░φ ╛ε╢▓ ╝°╝¡╖╬ ║╥╕«┤┬┴÷ ╛╦ ╝÷ └╓┤┘. └╠ ┴÷╜├╛ε└╟ ╚┐░·┤┬
- "<code>Example directive declared here: YES/NO</code>"╖╬
- ╚«└╬╟╥ ╝÷ └╓┤┘.</p>
- </usage>
- </directivesynopsis>
-
- </modulesynopsis>
-